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Abstract 

Modern genonnic analysis often requires workflows incorporating nnultiple 
best-of-breed tools. GenonneSpace is a web-based visual workbench that 
connbines a selection of these tools with nnechanisnns that create data flows 
between thenn. One such tool is Cytoscape 3, a popular application that 
enables analysis and visualization of graph-oriented genonnic networks. As 
Cytoscape runs on the desktop, and not in a web browser, integrating it into 
GenonneSpace required special care in creating a seannless user experience 
and enabling appropriate data flows. In this paper, we present the design and 
operation of the Cytoscape GenonneSpace app, which acconnplishes this 
integration, thereby providing critical analysis and visualization functionality for 
GenonneSpace users. It has been downloaded over 850 tinnes since the 
release of its first version in Septennber, 2013. 
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Amendments from Version 1 

I added text to clarify issues that each of the reviewers raised. 
Some changes were corrections of simple typos (e.g., removing 
unnecessary "it" from the last sentence of the Abstract, or fixing 
the spelling of an author name in the References section). Other 
changes were one sentence clarifications that help focus or 
disambiguate the discussion. 

See referee reports 



Introduction 

GenomeSpace is a web-based application (http://genomespace.org) 
that provides a workspace environment for executing biologic 
analysis workflows involving genomic data. It hosts a variety of 
third party tools that it can launch to perform queries of public 
genomic databases, customized analyses, and customized visual- 
ization and publishing. The data and results from a given tool are 
stored by GenomeSpace as private, public, or shared files that are 
made available to other tools in the workspace. Cytoscape is a stand- 
alone desktop application that enables users to analyze, visualize, 
and publish complex networks - with its GenomeSpace app ("the 
app", http://apps.cytoscape.org/apps/genomespace), it doubles as 
a tool available to GenomeSpace workflows. This paper describes 
Cytoscape 's GenomeSpace app, which links GenomeSpace and 
Cytoscape, thereby enabling data to flow between Cytoscape and 
other GenomeSpace tools. It focuses on critical design issues for 
the app, and gives a brief app demonstration highlighting the result- 
ing user interface and data transfer functionality. 

While there exists a number of workflow engines that can perform 
biological analyses (e.g., Taverna^ BioKepler^, and Galaxy^), 
GenomeSpace distinguishes itself by combining a collaboration- 
oriented file system (incorporating sharing and stored metadata), 
a robust and user-extensible spectrum of genomic tools, and a 
library of recipes demonstrating best practices for the orchestration of 
GenomeSpace tools to achieve common and important bioinformatic 
results. While some tools implement specific and constrained function- 
ality (e.g., ISAcreator^), others are complex and rich applications (e.g., 
GenePattem\ Gitools^, and Cistrome^), and yet others are fully featured 
workflow management systems themselves (e.g.. Galaxy and Sage 
Synapse^). By tying these features together, GenomeSpace provides a 
comprehensive and effective environment for genomic research. 

GenomeSpace offers a short list of tools that enable network visual- 
ization and analysis, including Cytoscape, Genomica (http://genom- 
ica.weizmann.ac.il/) (for module network trees), Gitools^ (for heat 
maps), and IGV^ (for sequencing data). Cytoscape distinguishes 
itself by being graph-oriented and delivering rich filtering, layout, 
and visual style features backed up by an extensive collection of 
third-party apps"\ including pathway analysis, data integration, GO 
annotation, and more. 

To launch a tool, GenomeSpace opens a new browser page using a 
URL specific to the tool. Paradoxically, Java-based tools (such as 
Cytoscape) run directly on the user's workstation instead of within 
a browser. In this paper, we describe a specialized launch strategy 
that addresses this. We also describe Cytoscape' s GenomeSpace 
app, how its user interface adds GenomeSpace functionality within 



Cytoscape, and how it uses GenomeSpace' s Client Development 
Kit (CDK) to access the GenomeSpace file system to read input 
files or write result files. 

Note that GenomeSpace supports two Cytoscape tools it calls 
"Cytoscape" and "Cytoscape 3". Its "Cytoscape" refers to the 
deprecated Cytoscape version 2, and its "Cytoscape 3" refers to 
Cytoscape version 3, which is the currently released version (http:// 
cytoscape.org). Within this paper, we discuss only the "Cytoscape 3" 
tool, and refer to it simply as "Cytoscape". 

Implementation 

The Cytoscape support for GenomeSpace exists in three parts: the 
launch support, Cytoscape's GenomeSpace app, and Cytoscape it- 
self. This section describes how the launch support and app work, 
and leaves the operation of Cytoscape to the Results section below. 
Technical details of Cytoscape internal organization, construction, 
APIs, data structures, and general conventions can be found in 
the Cytoscape App Developer wiki (http://wiki.cytoscape.org/Cy- 
toscape_3/AppDeveloper). 

Launch 

To launch a tool, a GenomeSpace user left-clicks on the corres- 
ponding toolbar icon, which activates the tool via the tool's 
URL. For Cytoscape, the URL references a launch descriptor file 
that adheres to the Java Network Launch Protocol (JNLP)^^ and 
resides on the Cytoscape web site. Web browsers process a JNLP 
file URL by starting a specialized launcher that downloads a Java 
application named in the JNLP file, then executes it on the user's 
workstation. In Cytoscape's case, we created a dynamic JNLP file 
(as a PHP script that delivers a JNLP file) that executes a small 
LaunchHelper Java application (see Figure 1). GenomeSpace con- 
structs the JNLP URL to contain a GenomeSpace file descriptor 
as a parameter, and the PHP script extracts it and defines it as a 
parameter to the LaunchHelper (see Supplementary Data, particu- 
larly as the value used for the SomeGenomeSpaceFilelD in the 
gs.url argument). 

The LaunchHelper tests for the presence of Cytoscape and 
Cytoscape's GenomeSpace app, and installs them if they are not 
present. Because LaunchHelper is itself a Java application, it is 
able to download the Cytoscape installer appropriate for the user's 
workstation and the GenomeSpace app while maintaining an in- 
teractive user interface, including appropriate installation dialog 
boxes (as JOptionPane) and progress bars (as ProgressMonitorln- 
putStream). 

Note that before attempting to launch Cytoscape, GenomeSpace 
attempts to determine if Cytoscape is already running by using the 
JRAC protocol (http://code.google.eom/p/jrac) - if it is, Cytoscape 
simply starts a new session. 

GenomeSpace app 

The GenomeSpace app manages the relationship between Cytoscape 
and GenomeSpace once Cytoscape is running. In addition to respond- 
ing to a JRAC request (above), it augments the Cytoscape user 
interface to allow the user to directly access the GenomeSpace file 
system and tools. 
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Figure 1. Launching Cytoscape from GenomeSpace. 



Building app menus 

The app exposes a number of GenomeSpace functions as menu items 
under Cytoscape's File and Apps menus. This enables Genome- 
Space login, opening and saving GenomeSpace sessions, launching 
GenomeSpace tools, and importing and exporting networks and 
tables as GenomeSpace files. Networks can be exported in .sif, .cyjs, 
.nnf, PSI-MI, and .xgmml formats. While some menu items are posi- 
tioned within Cytoscape's top-level menus (e.g., session open and 
save menu items in the File menu), others are positioned in sub- 
menus within Cytoscape menu items (e.g., importing a network 
under File | Import | Network). For nice effect, each menu item 
identifies itself with a distinctive GenomeSpace logo and uses menu 
gravity to place itself consistently relative to existing Cytoscape 
menu items. (It uses setPreferredMenu to add the menu, setMenu- 
Gravity to position it, and put Value to set the small icon). 

GenomeSpace communication strategy 

To implement these menu items, the app communicates with 
GenomeSpace via the GenomeSpace CDK (http://www.genome- 
space.org/support/api/cdk), a proxy interface to GenomeSpace 
carried over an SSL Internet connection. The CDK enables 
GenomeSpace session management, tool discovery, user authenti- 
cation, file system listing, and file upload and download. As with 
other apps, the app's cy Activator initializes the app state, including 
gaining references to the standard Cy objects: application, network, 
view, and table managers. It also initializes basic CDK-related state 
(e.g., the GenomeSpaceContext root context). 

GenomeSpace file I/O 

In addition to communicating with GenomeSpace, the CDK dis- 
plays key GenomeSpace-related dialog boxes, including the login 
dialog and a file chooser for import and export functions. The app 
uses file choosers to identify an import (or export) file (referenced 
by metadata), but then executes the operation using a combination 
of CDK download/upload functions and Cytoscape task manager 
and monitor functions. 

For example, given metadata for a network file to import, the app 
creates a Cytoscape task iterator that downloads the network to a 
temp file, loads the network into Cytoscape, and then deletes the 



temp file as shown in the Supplementary Data. DownloadFile- 
FromGenomeSpaceTask calls CDK to perform the download, and 
loadNetworkFileTaskFactory adds the network to the Cytoscape 
data model. Because the app orchestrates the download using 
Cytoscape's task manager, its progress is automatically tracked and 
reported by Cytoscape's task monitor. 

Results 

The GenomeSpace app enables Cytoscape to act as a tool in a work- 
flow executed within the GenomeSpace web application. From the 
Cytoscape perspective, genomic data can come from numerous 
sources and can be rendered to numerous destinations, where the 
GenomeSpace file system can be a source, a destination, or both. 
To facilitate this, GenomeSpace also allows the user to identify a 
GenomeSpace- stored Cytoscape session file (.cys) while launching 
Cytoscape, thereby facilitating a seamless tool launch. 

Additionally, the app adds menu items to Cytoscape to enable 
loading or saving a Cytoscape session, a network, or node or edge 
attributes in the GenomeSpace file system from within Cytoscape. 
Each menu item enables the user to navigate within the file system 
using a chooser. 

Note that the GenomeSpace app makes the GenomeSpace file sys- 
tem available to Cytoscape even without the user first executing 
the GenomeSpace web application. In this case, Cytoscape enables 
the user to log into GenomeSpace within Cytoscape, and then use the 
app-injected menus to access workflow-related data files. 

Demonstration 

As a demonstration of typical Cytoscape usage, we show how to 
use Cytoscape to integrate gene expression data with a pre-defined 
genomic network, where both the network and gene expression 
data reside in the GenomeSpace file system. The network was cre- 
ated in a prior Cytoscape session and stored in the GenomeSpace 
file system so it could be shared as a template with collaborators 
and integrated with various gene expression datasets produced dur- 
ing an ongoing study. The test network is a portion of the BioGrid 
H. sapiens network. The gene expression data represents the output 
of some previously executed GenomeSpace tool, such as Galaxy. 
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To load the template network into Cytoscape, use a web browser 
on a workstation having at least 6GB RAM. Log into Genome- 
Space. org - you can easily create a user ID if you don't have one. 
Right-click on the "Cytoscape 3" tool, and choose the Launch on 
File menu item. Choose the Cytoscape session file (.cys) contain- 
ing the H. sapiens network template by browsing the file system 
to /bdemchak/FlOOOExample, then dragging it to the launch box 
and clicking Launch. Once Cytoscape has started and the net- 
work has loaded, you will see a small network in a view window 
(Figure 2). 

To load a gene expression dataset, choose Cytoscape' s File | Import 
I Table | GenomeSpace menu item, and use the chooser to select the 
enrichment data in the /bdemchak/FlOOOExample folder. Cytoscape 
will display an Import Columns from Table dialog - when you 
click on OK, note that the enrichment data (including values in the 
HSC1_1 column) has been added to the node table. 

Finally, to use the gene expression data to color the network, select 
Cytoscape' s Style tab and choose the RedYellowGreen style from 
the style dropdown. Nodes are colored by their associated HSC1_1 
value, and nodes having no HSC1_1 value are left white (Figure 3). 
This style is part of the Cytoscape session file loaded for this 
example, and illustrates that all Cytoscape functionality is available 
in Cytoscape operating as a GenomeSpace tool. 

Refer to the Cytoscape manual (http://wiki.cytoscape.org/Cytoscape_3/ 
UserManual) and tutorials (http://tutorials.cytoscape.org) for a 
more detailed treatment of Cytoscape workflows. 



\M BIQGRIP-ORGANISM-Homo_:?ipienj-3.2.105.mi... ' [""^^T^^ 





Figure 2. Template H. sapiens before gene expression data. 



Figure 3. Template H. sapiens after gene expression data. 
Conclusions 

The GenomeSpace app shows how Cytoscape can be used as a plugin 
to a web application as part of a larger workflow, and then how to 
integrate external services into Cytoscape 's workflow. 

Software availability 

Software available from: http://apps.cytoscape.org/apps/genomespace 
Latest source code: 

https://github.com/idekerlab/genomespace-cytoscape-weblaunch 

https://github.com/idekerlab/genomespace-cytoscape 

Source code as at the time of publication: https://github.com/F1000Re- 
search/genomespace-cytoscape- weblaunch/releases/tag/v 1 .0 

https://github.com/F1000Research/genomespace-cytoscape/releas- 
es/tag/Vl.O 

Archived source code as at the time of publication: http://www. 
dx.doi.org/10.5281/zenodo.10441i2 

http://www.dx.doi.org/10.5281/zenodo.10536i3 

License: Lesser GNU Public License v2.1 
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Supplementary data 

TasklVlanager downloads GenomeSpace file 

// Create a local temp file having the GenomeSpace file name 
File tempFile = new File (System. getProperty ( ''java . io . tmpdir" ) , 

fileMetadata . getName ( ) ) ; 

// Create a task iterator that executes a GenomeSpace file download 
Tasklterator ti = new Tasklterator (new DownloadFileFromGenomeSpaceTask 

(session, fileMetadata, 
dataFormat, tempFile, true) ) ; 
// Add a task that loads the network into Cytoscape from the tempfile 
ti . append ( loadNetworkFileTaskFactory . createTasklterator ( tempFile) ) ; 

// Add a task that deletes the temp file after the load 
ti . append (new DeleteFileTask ( tempFile) ) ; 

// Execute the tasks 
dialogTaskManager . execute ( ti ) ; 

Sample JNLP file generated by cytoscape. php 

<?xml version="l . 0" encoding="utf -8 " ?>< jnlp codebase="http: //chianti .ucsd. edu/ 
genomespace-cy3 "> 
<inf ormation> 

<title>Cytoscape</ title> 
<vendor>Cytoscape Consortium< / vendor> 
<homepage href ="http : / /cytoscape . org" /> 
<o ffline- all owed/ > 
</inf ormation> 
<security> 

<all-permissions/> 
</security> 

<update check=" always" policy^ "always " /> 
<resources> 

<j2se version="l . 5+" 

j ava-vm-args = " -Dsun . lang . ClassLoader . allowArraySyntax=true" 
max-heap-size="1024M" /> 
< jar href ="lib/genomespace-cytoscape-weblaunch-2 .0.1. jar" main=" true" /> 

</resources> 

<application-desc main-class="cytoscape . weblaunch. LaunchHelper"> 
<argument>-p</argument> 
<argument> . </argument> 
<argument> - P< / argument > 

<argument>gs . url=SomeGenomeSpaceFileID</argument> 
</application-desc> 
</ jnlp> 
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Current Referee Status: 
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Referee Responses for Version 1 



Jan Aerts 

Bioinformatics, KU Leuven, Leuven, Belgium 

Approved: 04 August 2014 

Referee Report: 04 August 2014 
doi:1 0.5256/f 1 000research.4805.r5449 

In the paper "Cytoscape: the network visualization tool for GenomeSpace workflows", Demchak etal. 
describe the design, implementation and operation of an interaction layer between Cytoscape and 
GenomeSpace. 



Unfortunately, I was not able to run the example described in the manuscript, due to a "unable to find the 
document" error. 



Overall, the manuscript gives a fair description both of the technology used for integrating Cytoscape into 
GenomeSpace and its use. This however does mean that the actual focus is not completely clear. If the 
message is "there is a new tool accessible from GenomeSpace" which would be aimed at the end-user, 
then terms like "JRAC" and "cyActivator" cannot be expected to be understood without further 
explanation. Care should be given to explain these sufficiently enough for lay-people. On the other hand, 
the message could also be "here is how to integrate a web-tool with a desktop application", in which case 
the technical part might be described a bit more in depth. 

I expect this paper and the bridge between Cytoscape and GenomeSpace will be of considerable interest 
to the community. 

Minor textual remarks: 

• In the abstract, there is an extra "it" in "It has been downloaded it over 850 times". 

• Hyphenation has gone awry in many cases. Although this is not important for the contents of the 
manuscript, it does start to bother the reader after a while. These include (but are not limited to): 
"GenomeS-pace", "submen-us", "grav-ity", "Genom-eSpace", "Genom-eSpaceContext", 
"attrib-utes", and "Bi-oGrid". 

I have read this submission. I believe that I have an appropriate level of expertise to confirm that 
it is of an acceptable scientific standard. 



Competing Interests: No competing interests were disclosed. 
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Barry Demchak, 

Posted: 05 Aug 2014 

Thank you, Jan, for the thoughtful comnnents. We are looking into the issue of Cytoscape not 
launching from the web site. As a workaround, you can either hit the OK button on the browser 
error window, or launch Cytoscape on your PC before attempting to launch it from GenomeSpace. 
You can also get the Cytoscape session file directly from GenomeSpace by launching Cytoscape, 
and using the File I Open from GenomeSpace menu item. Also, we'll address the mechanical and 
explanation issues in a revision in the next few days. Thank you! 
Competing Interests: No competing interests were disclosed. 




Gabriela Bindea, Bernhard MIecnik 

Laboratory of Integrative Cancer Immunology, Cordelier Research Center, Paris, France 



Approved: 04 August 2014 

Referee Report: 04 August 2014 
doi:1 0.5256/f 1 000research.4805.r5651 

The paper "Cytoscape: the network visualization tool for GenomeSpace workflows" describes the 
GenomeSpace app, a tool that facilitates data analysis in Cytoscape for GenomeSpace users. This is a 
nice try to bridge two communities: cytoscapers & genomespacers. 

The resources and tools included in GenomeSpace are well presented, and the important data sharing 
possibility is underlined. At the same time, the extensive app collection of Cytoscape with its multiple 
analysis possibilities is very short mentioned. This could be maybe extended so that users of 
GenomeSpace could use Cytoscape not only to visualize their results obtained in GenomeSpace, but 
also to analyze their data with Cytoscape apps. But this will be probably the topic of another paper. 

For running the app, the computer should have enough memory, as mentioned in the article. Some GUI 
adjustments should be done for the different OS, for instance in Ubuntu the login dialog size should be 
increased, the buttons are not entirely visible at the moment. The new functionality is nicely underlined 
with icons, but is scattered throughout the menu. To increase the usability/visibility, after the login it would 
be good e.g. to add also the import/export buttons into the tool bar in top. 

The app performs well. It remains to the users of both communities to discover the multiple possibilities 
that this app offers. 

We have read this submission. We believe that we have an appropriate level of expertise to 
confirm that it is of an acceptable scientific standard. 

Competing Interests: No competing interests were disclosed. 
1 Comment 
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Barry Demchak, 

Posted: 05 Aug 2014 

Thanks, Gabriela, for all of your helpful comments. The timing is good, as we're working a new 
Cytoscape release. We'll take a closer look at the dialog boxes. I don't think there's anything we 
can do about toolbar icons until the Cytoscape 3.3 release in 201 5, but we'll certainly try to add the 
feature then. 

Competing Interests: No competing interests were disclosed. 



Aris Floratos 

Department of Systems Biology, Columbia University, New York, NY, USA 

Approved: 30 July 2014 

Referee Report: 30 July 2014 

doi:1 0.5256/f 1 000research.4805.r5291 

Language/spelling: 

The language is acceptable but would benefit from a more careful reading/editing. Some examples where 
improvements are possible are: 

• "Javabased" should be corrected to "Java-based". 

• In the sentence that begins "Web browsers are defined to process a JNLP file URL by starting a 
specialized launcher...", the portion that reads "are defined to" is extraneous. 

• In the sentence that reads "Paradoxically, Javabased tools (such as Cytoscape) run directly on the 
user's workstation instead of within a browser", it is not clear what is paradoxical about the 
described execution protocol. The word "paradoxically" should/could be dropped or maybe be 
replaced by a more appropriate adverb. 

Comments on specific sections: 

• Launch: there is a sentence that reads "GenomeSpace constructs the JNLP URL to contain a 
GenomeSpace file descriptor as a parameter, and the PHP script extracts it and defines it as a 
parameter to the LaunchHelper (see Supplementary Data)." It would add to clarity to explain what 
the file referenced is. 

• GenomeSpace app: This section appears written with the assumption that the reader is already 
familiar with the Cytoscape app framework, essentially no background is provided. 

• GenomeSpace communication strategy: Same comment as above: the article refers to 
Cytoscape-specific programming constructs without introducing them or providing relevant 
references for disambiguation. E.g., in the sentence "As with other apps, the app's cyActivator 
initializes the app state, including gaining references to the standard Cy objects: application, 
network, view, and table managers", terms like "cyActivator" and "Cy objects" are used without 
prior definition/explanation. The same issue exists with GenomeSpace-specific objects, e.g., the 
sentence "It also initializes basic CDK-related state (e.g., the GenomeSpaceContext root context)". 
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Demonstration: It would be helpful to describe what the columns of the input data file 
EnrichnnentData.dat represent. 



• Demonstration: The demonstration would benefit from a more detailed analysis workflow. E.g., a 
gene expression data set and a class file can be processed by GenePattern (or some other 
GenomeSpace tool) to generate a list of differentially expressed genes for some reasonable pair of 
case/control phenotypes and then feed the resulting file into Cytoscape. This could also help 
demonstrate the value proposition of GenomeSpace, i.e., providing the ability to seamlessly use 
multiple tools within an integrated environment. The authors may also want to briefly discuss why 
people are often interested in visualizing enriched/differentially-expressed genes in the context of a 
network, this would help the less-initiated better appreciate the value of having Cytoscape 
available as a GenomeSpace tool. 
Overall Impression: 

This is an informative article, describing how a specific tool (Cytoscape) has been integrated into an 
innovative framework (GenomeSpace) that enables seamless access to multiple bioinformatics tools. The 
main concern is overall readability in the absence of sufficient background on the Cytoscape app 
framework, to put the implementation of the GenomeSpace app in proper context. The other issues are 
minor and can be easily addressed. 

I have read this submission. I believe that I have an appropriate level of expertise to confirm that 
it Is of an acceptable scientific standard. 

Competing Interests: Non-financial competing interest: I have in the past collaborated with some of the 
article authors. 

1 Comment 



Barry Demchak, 

Posted: 05 Aug 2014 

Thank you, Aris. Your observations and suggestions are very valuable, and we'll upgrade the paper 
accordingly. We really appreciate your detailed observations. Look for a new version in a couple of 
days. 

Competing Interests: No competing interests were disclosed. 
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Barry Demchak, 

Posted: 24 Jul 2014 

©MichelDumontier: Thanks for the thoughtful comments. The ground rules for this paper collection 
involved writing a 2 pager (or slightly more) on a Cytoscape App. So, this paper is App-centric.Your point, 
though, goes towards demonstrating the value of GenomeSpace in the first place, which is yet a separate 
paper, and would be enormously valuable. We'll try to write that next. 
Competing Interests: No competing interests were disclosed. 



Michel Dumontier, Carleton University, Canada 
Posted: 15 Jul 2014 

Linking Cytoscape with other applications through GenomeSpace seems like a small step to starting tying 
together different software. To demonstrate the value of using GenomeSpace, the authors should walk us 
through an example that makes use of other software to generate cytoscape input and/or further process 
cytoscape output. Otherwise, how is this different than just using Cytoscape? Additionally, the paper 
should clearly articulate the scientific merit of its example : what biological insight do we obtain in 
overlaying gene expression data on this pre-generated network file? 
Competing Interests: No competing interests were disclosed. 



Nigam Shah, 

Posted: 11 Jul 2014 

Tying together the best Web based workflow software for genomic analysis with the best network analysis 
tool is highly valuable. Fun to give it a try! 
Competing Interests: none 
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